Skip to main content
POST
Create a native style.

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Body

application/json
css
string
required

CSS stylesheet for this style.

format_id
string<uuid>
required

ID of the NativeFormat this style belongs to.

html
string
required

HTML template string. Variable placeholders match NativeFormatVariable.name.

name
string
required
Minimum string length: 1
description
string | null

Optional description of the style.

editor_config
any | null

Frontend guided editor state. Opaque to backend; serving uses html/css.

editor_type
enum<string>
default:guided

Editor type: GUIDED (form-based) or CODE (raw HTML/CSS).

Available options:
guided,
code
height
integer | null

Fixed height of the ad unit in pixels.

Required range: x >= 0
is_fluid
boolean
default:false

Whether this style should stretch to fill the container width.

template_id
string<uuid> | null

ID of the NativeStyleTemplate applied to this style.

width
integer | null

Fixed width of the ad unit in pixels. Ignored when is_fluid is true.

Required range: x >= 0

Response

Successful Response

created_at
string<date-time>
required
css
string
required

CSS stylesheet for this style.

format_id
string<uuid>
required

ID of the NativeFormat this style belongs to.

html
string
required

HTML template string. Variable placeholders match NativeFormatVariable.name.

id
string<uuid>
required

Unique identifier (UUID v4).

name
string
required

Human-readable name of the style.

owner_id
string<uuid>
required

ID of the operator who owns this style.

updated_at
string<date-time>
required
description
string | null

Optional description of the style.

editor_config
any | null

Frontend guided editor state. Opaque to backend; serving uses html/css.

editor_type
enum<string>
default:guided

Editor type: GUIDED (form-based) or CODE (raw HTML/CSS).

Available options:
guided,
code
height
integer | null

Fixed height of the ad unit in pixels.

Required range: x >= 0
is_fluid
boolean
default:false

Whether this style should stretch to fill the container width.

no
integer | null
status
enum<string>
default:inactive

Operational status of the style.

Available options:
active,
inactive
template_id
string<uuid> | null

ID of the NativeStyleTemplate applied to this style.

width
integer | null

Fixed width of the ad unit in pixels. Ignored when is_fluid is true.

Required range: x >= 0